home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / setreuid.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  44 lines
  1.  
  2. SETREUID(3)                UNIX Programmer's Manual                SETREUID(3)
  3.  
  4. NNAAMMEE
  5.      sseettrreeuuiidd - set real and effective user ID's
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _i_n_t
  11.      sseettrreeuuiidd(_i_n_t _r_u_i_d, _i_n_t _e_u_i_d)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The real and effective user ID's of the current process are set according
  15.      to the arguments.  If _r_u_i_d or _e_u_i_d is -1, the current uid is filled in by
  16.      the system.  Unprivileged users may change the real user ID to the effec-
  17.      tive user ID and vice-versa; only the super-user may make other changes.
  18.  
  19.      The sseettrreeuuiidd() function has been used to swap the real and effective user
  20.      IDs in set-user-ID programs to temporarily relinquish the set-user-ID
  21.      value.  This purpose is now better served by the use of the sseetteeuuiidd()
  22.      function (see setuid(2)).
  23.  
  24.      When setting the real and effective user IDs to the same value, the stan-
  25.      dard sseettuuiidd() function is preferred.
  26.  
  27. RREETTUURRNN VVAALLUUEESS
  28.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  29.      of -1 is returned and _e_r_r_n_o is set to indicate the error.
  30.  
  31. EERRRROORRSS
  32.      [EPERM]       The current process is not the super-user and a change oth-
  33.                    er than changing the effective user-id to the real user-id
  34.                    was specified.
  35.  
  36. SSEEEE AALLSSOO
  37.      getuid(2),  seteuid(2),  setuid(2)
  38.  
  39. HHIISSTTOORRYY
  40.      The sseettrreeuuiidd() function call appeared in 4.2BSD and was dropped in
  41.      4.4BSD.
  42.  
  43. 4th Berkeley Distribution       March 10, 1991                               1
  44.